uncontrolled copy when printed or downloaded. please refer to the 4d systems website for the latest revision of this document raspberry pi display module pack featuring a 3.2 wide display module ulcd - 32w - ptu - pi document date: 4 th september 2013 document revision: 1. 2 d atasheet 4d systems turning technology into art
ulcd - 24 - ptu - pi C raspberry pi display module pack contents 1. description ................................ ................................ ................................ ............................. 3 2. advanced hardware options ................................ ................................ ................................ .. 4 3. c library functions (for use with the serial/spe environment) ................................ ................. 5 4. specifications and ratings ................................ ................................ ................................ ....... 8 5. legal notice ................................ ................................ ................................ ............................ 9 6. contact inf ormation ................................ ................................ ................................ ............... 9
4d systems ulcd - 32w - ptu - pi ? 201 3 4d systems page 3 of 9 www.4dsystems.com.au ulcd - 32w - ptu - pi C raspberry pi display module pack 1. d escription the 4d systems 3.2 wide pi display module pack ( ulcd - 32w - ptu - pi ) is made up of a ulcd - 32w - ptu display module specifically customised for the raspberry pi . the pack comprises of: ? ulcd - 32w - ptu display module ? 4d serial pi adaptor ? 5 way female - female cable the raspberry pi display module pack enables a raspberry pi user to quickly connect the 4d serial pi adaptor to their raspberry pi , connect the 5 way cable between the adaptor and the display module, and be connected in seconds to start programming their new 4d systems display. the display module can be programmed in a number of ways, using the 4d systems workshop 4 ide software. by default the display module will come loaded with the serial application. please refer to the next section of this document for alternative configuration options. the ulcd - 32w - ptu has a comprehensive range of serial commands ready to be received from the raspberry pi , to draw primitives such as lines, rectangles, circles and text, to displaying images, playing sound and logging data to usd card. communication to the display module is performed via the raspberry pis serial port (rx and tx) . power for the display is supplied from the raspberry pis 5v bus. no external power is required for the display module as all power is supplied from the raspberry pi , via the adaptor. for a detailed listing of the serial commands available, please refer to the appendix section of this document. note (*): raspberry pi remains the property of the raspberry pi foundation. all references to the words raspberry pi are trademarks of the raspberry pi foundation, and all references to 4d systems modules/adapto rs with the raspberry pi are based on compatibility with the raspberry pi hardware, and do not indicate ownership of or to the raspberry pi in any way. 4d serial pi adaptor the ulcd - 32w - ptu display module raspberry pi display module pack connected (note: raspberry pi not included)
4d systems ulcd - 32w - ptu - pi ? 201 3 4d systems page 4 of 9 www.4dsystems.com.au ulcd - 32w - ptu - pi C raspberry pi display module pack 2. advanced hardware options the display module ( ulcd - 32w - ptu) is a very capable and powerful piece of hardware, which can be reconfigured beyond the boundaries of the serial environment, which is what is loaded on the module when shipped. with the use of the 4d systems workshop4 ide software, the display modul e can be configured and programmed, which enables the user to utilise the display module in more ways than what is possible when using it in the serial configuration. if a user wishes to investigate the capabilities of the ulcd - 32w - ptu and reconfigure the display module, please refer to the datasheet for the ulcd - 32w - ptu, available from the 4d systems website, www.4dsystems.com.au . the user can freely change back to the configuration the module was shipped in if desired, all via the workshop4 ide software. to take advantage of the 4d systems workshop 4 software, a 4d programming cable is required, which can be purchased from the 4d systems website, or from a 4d systems distributor. depending on what the user requ ires, a micro - sd card may also be required. please refer to the datasheet for the ulcd - 32w - ptu for more information, along with information on the starter kits which is also available, which includes both the programming cable and a micro - sd card. if the ulcd - 32w - ptu display module is programmed to be used with the visi - genie environment, 4d systems has created a library for the raspberry pi specific for the visi - genie environment. please refer to the ulcd - 32w - ptu - pi product page on the website for more in formation, along with the link for the 4d systems github repository where this library is located for download. if the ulcd - 32w - ptu display module is programmed to be used with the serial environment, 4d systems have created a c library which is included with workshop 4, but also available to be downloaded from the 4d systems github repository. this library is a generic c library, so not specific to the raspberry pi, however can easily be ported as all source code is included in the repository. an alternat ive is to not use the library at all, and utilise the raw commands which can be sent from any host controller. please refer to the workshop 4 product page, and download the serial command set document for more information.
4d systems ulcd - 32w - ptu - pi ? 201 3 4d systems page 5 of 9 www.4dsystems.com.au ulcd - 32w - ptu - pi C raspberry pi display module pack 3. c library functions (for use with the serial/spe environment) the following is a list of the library functions available to use with the 4d systems c serial library, which is a generic c library which can be ported to run on the raspberry pi. the c serial l ibrary is compatible with the display module supplied with this pack when the display module is configured with the serial environment from the workshop4 ide. this listing below is not relevant if using the visi - genie environment. for detailed information on each of these functions, please refer to the picaso serial command set reference manual document, available from the workshop 4 product page on the 4d systems website, www.4dsystems.com.au graphics functio ns: ? gfx_cls() ? gfx_changecolour(oldcolour, newcolour) ? gfx_circle(x, y, radius, colour) ? gfx_circlefilled(x, y, radius, colour) ? gfx_line(x1, y1, x2, y2, colour) ? gfx_rectangle(x1, y1, x2, y2, colour) ? gfx_rectanglefilled(x1, y1, x2, y2, colour) ? gfx_polyline(n, vx, vy, colour) ? gfx_polygon(n, vx, vy, colour) ? gfx_triangle(x1, y1, x2, y2, x3, y3, colour) ? gfx_orbit(angle, distance) ? gfx_putpixel(x, y, colour) ? gfx_getpixel(x, y) ? gfx_moveto(xpos, ypos) ? gfx_lineto(xpos, ypos) ? gfx_setclipregion() ? gfx_ellipse(x, y, xrad, yrad, colour) ? gfx_ellipsefilled(x, y, xrad, yrad, colour) ? gfx_button(state, x, y, buttoncolour, textcolour, font, textwidth, textheight, text) ? gfx_panel(state, x, y, width, height, colour) ? gfx_slider(mode, x1, y1, x2, y2, colour, scale, value) ? gfx_screenco pypaste(xs, ys, xd, yd, width, height) ? gfx_trianglefilled(x1, y1, x2, y2, x3, y3, colr) ? gfx_polygonfilled(n, vx, vy, colr) ? gfx_get(mode) ? gfx_clipwindow(x1, y1, x2, y2) ? gfx_set(function, value) gfx_set shortcuts: ? gfx_bgcolour(colour) ? gfx_clipping(mode) ? gfx_transparentcolour(colour) ? gfx_transparency(mode) ? gfx_framedelay(delay) ? gfx_screenmode(delay) ? gfx_outlinecolour(colour) ? gfx_contrast(value) ? gfx_linepattern(pattern) ? gfx_bevelwidth(mode) ? gfx_bevelshadow(value) touch screen functions: ? touch_detectregion(x1, y1, x2, y2) ? touch_set(mode) ? touch_get(mode)
4d systems ulcd - 32w - ptu - pi ? 201 3 4d systems page 6 of 9 www.4dsystems.com.au ulcd - 32w - ptu - pi C raspberry pi display module pack text and string functions: ? charwidth('char') ? charheight('char') ? putstr(pointer) ? txt_set(function, value) txt_set shortcuts: ? txt_fgcolour(colour) ? txt_bgcolour(colour) ? txt_fontid(id) ? txt_width(multiplier) ? txt_height(multiplier) ? txt_xgap(pixelcount) ? txt_ygap(pixelcount) ? txt_opacity(mode) ? txt_bold(mode) ? txt_italic(mode) ? txt_inverse(mode) ? txt_underlined(mode) ? txt_attributes(value) ? txt_wrap(value) image control functions: ? img_setposition(handle, index, xpos, ypos) ? img_enable(handle, index) ? img_disable(handle, index) ? img_darken(handle, index) ? img_lighten(handle, index) ? img_setword(handle, index, offset, word) ? img_getword(handle, index, offset) ? img_show(handle, index) ? img_set attributes(handle, index, value) ? img_clearattributes(handle, index, value) ? img_touched(handle, index) media functions (sd/sdhc memory card): ? media_init() ? media_setadd(hiword, loword) ? media_setsector(hiword, loword) ? media_rdsector(destination_address) ? media_wrsector(source_address) ? media_readbyte() ? media_readword() ? media_writebyte(byte_val) ? media_writeword(word_val) ? media_flush() ? media_image(x, y) ? media_video(x, y) ? media_videoframe(x, y, framenumber) serial (uart) communications functions: ? setbaud(rate )
4d systems ulcd - 32w - ptu - pi ? 201 3 4d systems page 7 of 9 www.4dsystems.com.au ulcd - 32w - ptu - pi C raspberry pi display module pack fat16 file functions: ? file_error() ? file_count(filename) ? file_dir(filename) ? file_findfirst(fname) ? file_findnext() ? file_exists(fname) ? file_open(fname, mode) ? file_close(handle) ? file_read(destination, size, handle) ? file_seek(handle, hiword, loword) ? file_index(handle, hisize, losize, recordnum) ? file_tell(handle, &hiword, &loword) ? file_write(source, size, handle) ? file_size(handle, &hiword, &loword) ? file_image(x, y, handle) ? file_screencapture(x, y, width, height, handle) ? file_putc(char, handle) ? file_get c(handle) ? file_putw(word, handle) ? file_getw(handle) ? file_puts(source, handle) ? file_gets(*string, size, handle) ? file_erase(fname) ? file_rewind(handle) ? file_loadfunction(fname.4xe) ? file_run(fname..4xe, arglistptr) ? file_exec(fname..4xe, arglistptr) ? file_loadim agecontrol(fname1, fname2, mode) ? file_mount() ? file_unmount() ? file_playwav sound control functions: ? snd_volume(var) ? snd_pitch(pitch) ? snd_bufsize(var) ? snd_stop() ? snd_pause() ? snd_continue() ? snd_playing() timer functions: ? sys_sleep(units)
4d systems ulcd - 32w - ptu - pi ? 201 3 4d systems page 8 of 9 www.4dsystems.com.au ulcd - 32w - ptu - pi C raspberry pi display module pack 4. specifications and ratings recommended operating conditions parameter conditions min typ max units supply voltage (vcc) 4.5 -- 5.5 v operating temperature - 10 -- +70 c ordering information order code: ulcd - 32w - ptu - pi package: 138mm x 100mm x 30mm packaging: module sealed in antistatic foam padded 4d systems box
4d systems ulcd - 32w - ptu - pi ? 201 3 4d systems page 9 of 9 www.4dsystems.com.au ulcd - 32w - ptu - pi C raspberry pi display module pack 5. legal notice proprietary information the information contained in this document is the property of 4d systems pty. ltd. and may be the subject of patents pending or granted, and must not be copied or disclosed without prior written permission. 4d systems endeavours to ensure that the informa tion in this document is correct and fairly stated but does not accept liability for any error or omission. the development of 4d systems products and services is continuous and published information may not be up to date. it is important to check the curr ent position with 4d systems. 4d systems reserves the right to modify, update or makes changes to specifications or written material without prior notice at any time. all trademarks belong to their respective owners and are recognised and acknowledged. disclaimer of warranties & limitation of liability 4d systems makes no warranty, either expressed or implied with respect to any product, and specifically disclaims all other warranties, including, without limitation, warranties for merchantability, non - in fringement and fitness for any particular purpose. information contained in this publication regarding device applications and the like is provided only for your convenience and may be superseded by updates. it is your responsibility to ensure that your ap plication meets with your specifications. images and graphics used throughout this document are for illustrative purposes only. all images and graphics used are possible to be displayed on the 4d systems range of products, however the quality may vary. in no event shall 4d systems be liable to the buyer or to any third party for any indirect, incidental, special, consequential, punitive or exemplary damages (including without limitation lost profits, lost savings, or loss of business opportunity) arising ou t of or relating to any product or service provided or to be provided by 4d systems, or the use or inability to use the same, even if 4d systems has been advised of the possibility of such damages. 4d systems products are not fault tolerant nor designed, m anufactured or intended for use or resale as on line control equipment in hazardous environments requiring fail C safe performance, such as in the operation of nuclear facilities, aircraft navigation or communication systems, air traffic control, direct li fe support machines or weapons systems in which the failure of the product could lead directly to death, personal injury or severe physical or environmental damage (high risk activities). 4d systems and its suppliers specifically disclaim any express ed or implied warranty of fitness for high risk activities. use of 4d systems products and devices in 'high risk activities' and in any other application is entirely at the buyers risk, and the buyer agrees to defend, indemnify and hold harmless 4d syste ms from any and all damages, claims, suits, or expenses resulting from such use. no licenses are conveyed, implicitly or otherwise, under any 4d systems intellectual property rights. 6. contact information for technical support: support@4dsystems.com.au for sales support: sales@4dsystems.com.au website: www.4dsystems.com.au copyright 4d sys tems pty. ltd. 2000 - 2013 .
|
